﻿//4.16.1 标准的XML文档标签
/*

<summay>
    <summary>...</summary>
    指定IntelliSense为类型或成员显示的工具提示信息：一般为一个单词或句子。

*/
/*
 
<remarks>
    <remarks>...</remark>
    标签间的文本可以用于描述类型或成员。文档生成器会获取这些信息，然后将它合并到类型或成员的描述信息中。

*/

/*

 <param>
    <param name="name">...</param>
    解释方法的参数

*/

/*

<return>
    <returns>...</returns>
    解释方法的返回值。

*/

/*
 
 <exception>
    <exception [cref="type"]>...</exception>
    列出方法可能抛出的异常（cref指的是异常类型）
 
 */

/*
 
 <permission>
    <permission[cref="type"]>...</permission>
    指定文档记录的类型或成员所要求的IPermission类型。
 
 */

/*
 
 <example>
    <example>...</example>
    给出一个示例供文档生成器使用，通常包含描述信息和源代码（源代码一般位于<c>或<code>标签内）。

 */

/*
 
 <c>
    <c>...</c>
    指定一个内联代码片断。这个标签通常用在<example>代码块内。

 */

/*
 
 <code>
    <code>...</code>
    指定一个多行代码示例。这个标签通常用在<example>代码块内。

 */

/*
 
 <see>
    <see cref="member">...</see>
    将一个内联交叉引用插入到另一个类型或成员中。HTML文档生成器一般会将它转换为一个超链接。如果该类型或成员名是无效的，那么编译器会产生一条警告信息。如果要引用泛型类型，那么要使用花括号，例如cref="Foo{T,U}"。

 */

/*
 
 <seealso>
    <seealso cref="member">...</seealso>
    交叉引用另一个类型或成员。文档生成器一般会将它写入页面底部的一个单独的“See Also”小节中。

 */

/*
 
 <paramref>
    <paramref name="name"/>
    引用<summary>或<remarks>标签内的一个参数。

 */

/*
 
 <list>
    <list type=[ bullet | number | table]
        <listheader>
            <term>...</term>
            <description>...</description>
        </listheader>
        <item>
            <term>...</term>
            <description>...</description>
        </item>
    </list>
    指示文档生成器生成一个项目符号、编号或表格式的列表。

 */

/*
 
 <para>
    <para>...</para>
    指示文档生成器将指定内容单独作为一个段落。

 */

/*
 
 <include>
    合并包含文档的一个外部XML文件。path属性表示一个用于查询该文件中某个特定元素的XPath查询。

 */
//4.16.2 用户定义标签
//C#编译器所能识别的预定义XML标签没有突出的特点，但是可以定义自己的特殊标签。
//编译器唯一进行特殊处理的有<param>标签（通过这个标签验证参数名称及方法记录的所有参数）和cref属性（通过这个属性验证属性所指是一个真实的类型或成员，然后将它扩展为完整的类型或成员ID）。
//也可以在自定义标签使用cref属性，而且它的验证方式与预定义的<exception>、<permission>、<see>和<seealso>标签相同。
using System;

namespace _151_标准的XML文档标签
{
    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}
